ActiveField Technology Objects Overview Hierarchy Chart How to Start: Application Object How to work with Problems How to work with Model How to work with Data How to Analyze Results

DataDoc Object

Summary

The data description document.

Details

Represents a Data (Property) document. The DataDoc object is a member of the Documents collection that is available by the DataDoc property of the Application object. That collection contains all the DataDoc objects currently opened in QuickField. You can also get the primary DataDoc objects associated with the problem using the DataDoc property of the Problem object, or the secondary (library) one by the Library property.

Property Description or Data documents are specific to types of analysis (Electrostatics data, Stress Analysis data, etc.) These documents store the values of material properties, loadings and boundary conditions for different part labels. The Data document can be used as a material library for many different problems.

The DataDoc object inherits all the properties and methods of the generic Document class. Please see the IDocument class description to learn how to create a new data document or open an existing one, manage document's windows and other related topics.

The DataDoc contains Labels, divided into three collections:

Objects for manipulating with labels and physical data

Basic types of physical data

Each Label has an associated object containing physical data for it. It is accessible by the Content property of the Label object. The exact type of that object depends upon both the ProblemType and the Label's Type. In such situations when you do not need very specific details of physical data, you can use a generalized type of the label content object. These are: LabelBlock for block label, LabelEdge for edge label and LabelVertex for vertex label content.

The following example opens the "Magn1" problem and counts the labels of different types in the associated data document:

Dim prb As QuickField.Problem
Set prb = QF.Problems.Open(magn1.pbm)
Dim PropDoc As QuickField.DataDoc
Set PropDoc = prb.DataDoc
nBlockLabels = PropDoc.Labels(qfBlock).Count
nEdgeLabels = PropDoc.Labels(qfEdge).Count
nVertexLabel = PropDoc.Labels(qfVertex).Count